home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / nobit71.zip / NOBIT7.DOC < prev    next >
Text File  |  1988-10-19  |  5KB  |  123 lines
  1.  
  2.  
  3.  
  4.  
  5.                  No Bit 7 - Version 1.00
  6.  
  7.                 Copyright 1988, Ray Johns
  8.               =============================
  9.  
  10.        Purpose : To remove control characters from WordStar files.
  11.  
  12.          NOBIT7.COM is a small program I wrote up for my personal
  13.     use.  All it does is open the specified file and remove bit 7
  14.     from all the characters and writes them back to the original
  15.     file.  For along time I had a little program in BASIC that I
  16.     wrote up many years ago to do the same thing.  It got the job
  17.     done fine, but took forever and a day just to do a relatively
  18.     small file.  You may wonder of what use removing bit seven is
  19.     from text files.  There may be other uses for NOBIT7.COM, but
  20.     it's intended use it to "clean" text or source code files
  21.     generated by WordStar.  In the document mode, WordStar adds
  22.         "control characters" to some letters.  This can also happen in
  23.     the non-document mode in some cases to a lesser degree.  The
  24.     problem comes in when you try to use a file with these control
  25.     codes in a situation where they are not allowed, say for example,
  26.     in a source code being compiled by A86 or MASM (my main use for
  27.     NOBIT7.COM).  To fix the problem you must remove these control
  28.     characters (which are really YOUR characters + bit 7 or
  29.     chr$(128)), that's what NOBIT7.COM does.
  30.  
  31.          As I said, I had a BASIC program to do this, but is was
  32.     very, very slow... we're talking 2 or 3 minutes to do 70K source
  33.     code.  After I got up to speed in .ASM on the 8088 CPU, I wrote
  34.     up NOBIT7.COM to test out some of the file I/O stuff in DOS, it
  35.     turned out MUCH faster than the BASIC version (I knew there was a
  36.     reason why I learn assembly language!)  Infact, after a little
  37.     buffer tweaking, NOBIT7.COM would typically clean a 100K file in
  38.     just a few seconds.
  39.  
  40.          I never intended to send this little utility out the door, I
  41.     only wrote it as a test and used it in place of my BASIC program,
  42.     but the other day I looked on my favorite BBS and saw this little
  43.     program to "clean WordStar files."  I thought to myself, oooh
  44.     neat, I'll see it does anything different than my version.  To my
  45.     surprise the .COM file was over 13K !!!  To make matters worse,
  46.     the program took almost FIVE times as long to run and didn't have
  47.     any features beyond my version!  Geeze, bigger and slower, what
  48.     more could you ask for in a utility (grin).  So in an effort to
  49.     put off work that really needed to be done, I threw together this
  50.     the command line or via an input line and uploaded it to a few
  51.     BBS'es.  It's shareware, but I don't want any money, if you
  52.     really want to send me a buck or something, I won't say no.
  53.  
  54.          There's no help or anything because the program is pretty
  55.     straight forward.  You can use path names and filenames, no
  56.     wildcards, just non-ambiguous filename.  You can either say
  57.     NOBIT7 filename.ext and it will use that filename, or you can
  58.     just type NOBIT7 and it will ask you for an input file.  Be
  59.  
  60.  
  61.                     1
  62.  
  63.  
  64.  
  65.     careful not to run this on .COM or non-text files, it will remove
  66.     bit 7 from any file you specify.  I give this program to you in
  67.     an "as is" condition and you use it at your own risk.  Also
  68.     beware, that if you have graphic line drawing in your file or
  69.     your source code, this will reset the graphic bit (ie bit 7) and
  70.     make it text.  The program has error checking and all, but try to
  71.     use your head when you use it.  I use it on all my source codes
  72.     and have never had a problem, but keep in mind that it does read
  73.     and write to the same file, if you are dealing with a life and
  74.     death term paper make a .TMP file just incase a TSR or something
  75.     attacks while NOBIT7 is running.
  76.  
  77.          Oh, one last thing, I don't check free memory, the program
  78.     is under 1K long so I just use the other 63K in the current
  79.     program segment for a 50K read/write buffer, don't run this if
  80.     you have only 3K of memory free, I have no idea what will happen,
  81.     and I don't want to know (hahah, grin).  The little dots that
  82.     show up after the "Working" message equal blocks of data up to
  83.     50K long.  So for a 155K file you should see four dots,
  84.     50K+50K+50K and one for the last 5K.  It's very fast, even on my
  85.     XT, so don't blink when you run it on 50K or smaller files, they
  86.     only take a split second.  If you want to get a fresh copy, or
  87.     look at some of my bigger utility programs you are welcome to
  88.     call me at the SURF or CRICKET BBS.  The numbers follow, along
  89.     with the names of my two latest shareware programs.  If you don't
  90.     have them on your favorite BBS call and grab a copy for your part
  91.     of the country.
  92.  
  93.  
  94.               Other programs to look for from me :
  95.  
  96.          DMD200.ARC  - Disk meter, keep track of you disk space.
  97.          ZDIR100.ARC - Nice little DIR type program, check it out.
  98.  
  99.         BBS numbers for above and for NOBIT7.COM or just to chat.
  100.  
  101.            The Cricket BBS - 12/2400, 24 hours. (408) 373-3773
  102.            The SURF BBS    - 3/12, 24 hours.    (408) 649-6148
  103.  
  104.  
  105.          I'm logged on both as "RAY JOHNS" and I'm the remote sysop
  106.     of the second one, drop in anytime and say hello, love to hear
  107.     your comments on my programs or a program that you would like to
  108.     see.  Bye, hope you find NOBIT7.COM useful, if nothing else it
  109.     will be handy for improving those upload/download ratios!
  110.  
  111.  
  112.                 Ray Johns
  113.                 Box 1440
  114.                 Pebble Beach, CA. 93953
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                     2
  123.